Copyright: Copyright ® 1995, 1996 Stephen Darlington.


addZIP Compression Libraries

version 0.1

The easy-to-use, 16- and 32-bit, PKZIP-compatible compression APIs for Windows.

Add, extract, encrypt, decrypt, freshen, update, view, test etc.

How do I ... ?

Function reference

Warnings and errors

License

Registration

Distribution

Contacting the author

Release History

Acknowledgements


How do I ... ?

If your question isnt answered here, please contact the author.

How do I get started?

How do I create an archive?

How do I extract files from an archive?

How do I encrypt/decrypt files?

How do I view the contents of an archive?

How can I get feedback from the addZIP Compression Libraries?

How can I repair .ZIP archives?


How do I get started?

Please read the section relevant to your programming language.

Visual Basic

First you should add the addzip??.bas file to your project (where ?? is either 16 or 32). Next add the following lines to the Load event of your main (parent) form (where applicable).

Dim I as Integer

I = addZIP_SetParentWindowHandle(Me.hWnd)

I = addUNZIP_SetParentWindowHandle(Me.hWnd)

Users may wish to test the return value of these function calls in case there is a problem with setting the Windows handle (this will probably never occur, but you never know). See the function definitions for the reasoning behind these functions.


How do I create an archive?


How do I extract files from an archive?


How do I encrypt/decrypt files?

First of all you must register. Without registering you will only be able to encrypt/decrypt files using the password Unregistered.

When you registered, you will have been provided with a registration number. Use this, with the regsitered user name, in function calls to addZIP_Register and/or addUNZIP_Register. Calling addZIP_Encrypt with a password before adding files to an archive will then encrypt all further files added. Use addUNZIP_Decrypt with the appropriate password to extract encypted files from an archive.

N.B. Remember that after calls to addZIP() and addUNZIP(), all defaults will be reset.


How do I view the contents of an archive?


How can I get feedback from the addZIP Compression Libraries?


How can I repair .ZIP archives?

The short answer to this, at the moment, is that you cant. Well not with the addZIP Compression Libraries. PKWARE provides an excellent zip repair utility with its PKZIP package


Function reference

Compression functions

addZIP

addZIP_ArchiveName

addZIP_Encrypt

addZIP_Exclude

addZIP_ExcludeListFile

addZIP_Include

addZIP_IncludeListFile

addZIP_Register

addZIP_View

Decompression functions

addUNZIP

addUNZIP_ArchiveName

addUNZIP_Include

addUNZIP_IncludeListFile

addUNZIP_View


addZIP

This function starts the ZIP process going.

Syntax

Parameters

None.

Returns

This function generally returns the number of files processed. If -1 is returned, there is no .ZIP archive name specified. 0 indicates no files have been processed.

Remarks

This function should not be called without first specifying the name of the .ZIP archive (see addZIP_ArchiveName)

Example(s)


addZIP_ArchiveName


addZIP_Encrypt


addZIP_Exclude


addZIP_ExcludeListFile


addZIP_Include


addZIP_IncludeListFile


addZIP_Register

This function registers the addZIP Compression Libraries, allowing the use of your own passwords in the addZIP_Encrypt and addUNZIP_Decrypt functions

Syntax

The syntax for this function is provided in your registration pack.

Parameters

Returns

Remarks

Examples


addZIP_View


Warnings and errors

All warnings and error codes will be passed to the window defined by addZIP_SetWindow and addUNZIP_SetWindow. I have tried to keep the codes the same as those generated by PKZIP/PKUNZIP - registered users should refer to the documentation provided with that excellent software if my descriptions are unclear.


License

Unregistered (shareware) users should read the general and shareware licenses, registered users should read the general license and the relevant user license. By using the software, you indicate your agreement to the relevant license terms.

General license

The following apply to all users.

You may not reverse engineer, change or otherwise alter any part of the software (excluding the examples) without prior written permission from the author.

You may not produce and distribute in any way, a derived software product that may, directly or indirectly, compete with this software without prior written permission from the author.

This software is provided as-is, and no warranty of any kind (including, but not limited to, warranty for a particular purpose) is expressed or implied. The author will not be liable for any damage, data loss etc. caused by this program.

Shareware license

If you are not a registered user, the following apply to you as additions to the general license.

This is not free software. You may evaluate this software for a period of 30 days, after which you must register or delete the software from your hard disk. Use of this software beyond the 30 day evaluation period is expressly prohibited and violates national and international copyright law.

Private user license

If you are registered for private use only, the following apply as additions to the general license.

The software is for your own personal use and may be used on one PC only.

You must not disclose, distribute or make known to any other user your registration number.

You may not distribute (free or otherwise) any software which uses the addZIP Compression Libraries without first upgrading to a Developer license.

Developer license

If you are registered for developer use, the following apply as additions to the general license.

You may use this software on one PC only (unless a multiple developer license has been purchased).

You must not disclose, distribute or make known to any other user your registration number.

You may distribute any software which uses the addZIP Compression Libraries as long as it does not contravene any part of this license.

You inform the author of any (commercial or otherwise) distributed software.


Registration

Registration brings the following benefits

a diskette with the latest version of the addZIP Compression Libraries

a registration number that allows files within an archive to be encrypted/decrypted with your own password

free upgrades to all later versions

the right to distribute programs which make use of the addZIP Compression Libraries (developer and multi-user developer licensees only)

There are three levels of registration (all prices are inclusive of post and packing)

private user license. This is for the individual programmer who would like to use this software in his/her own programs but will not be distributing those same programs. The cost of this license is 30 UK pounds (50 US dollars).

developer license. This is for the individual programmer who will distribute programs that incorporate the addZIP libraries. The cost of this license is 50 UK pounds (80 US dollars).

multi-user developer license. This is for companies where the addZIP libraries will be used by more than one programmer. There is no limit on the number of users. The cost of this license is 100 UK pounds (160 US dollars).

To register you should send (preferably) a cheque (drawn on a UK bank) to Stephen Darlington, 5 Clowser Close, Watergardens, Sutton, Surrey SM1 4TP, United Kingdom. Money (most common denominations) are acceptable but please contact me first, and always send money through registered post. Alternatively US (and other overseas residents) may wish to send a cheque (drawn on a US bank) to Steve Fulton, 1540 First Street, Manhattan Beach, CA. 90266, USA.

When registering please provide the following information (where applicable); name, company, address, email address and registered user name.


Distribution

You are actively encouraged to distribute this software amongst your friends and colleagues, upload it your favourite BBS, shareware library and ftp/WWW sites, and include it in diskette and CD-ROM software collections, provided the following conditions are met

you distribute the exact, unmodified archive

you do not charge for this software (apart from a modest handling fee when applicable)

you make it clear that this software is provided as shareware (on a try before you buy basis)

you inform the author of your actions

If you are unsure about this distribution policy, or wish to discuss any distribution channel not specifically mentioned, please feel free to contact the author.


Contacting the author

Please contact the author with your suggestions, bug reports etc. via one of the following contact points:

E-mail: tcrstephen@epidem.icr.ac.uk (until 30th June 1996)

Telephone: UK 0181-643-8078 (evening, answerphone during the day)

Address:	Stephen Darlington

5 Clowser Close

Watergardens

Sutton

Surrey

SM1 4TP

United Kingdom


Release history


Acknowledgements

All product names mentioned in the addZIP Compression Libraries are trademarks or registered trademarks of their registered owners.

Thanks to everybody who had a hand in producing this software, particularly

PKWARE, Inc. - for producing the best example of shareware around

InfoZIP - for releasing the source-code to ZIP/UNZIP providing many answers to my queries on .ZIP structure etc.

members of the VISBAS-L and WINDEV mailing lists - for offering solutions to all my questions

Steve Fulton - for being my US contact (and a true ALARMist)

Mike Peters - for providing the background music.

I thank you all.